home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / vtimes.0 < prev   
Text File  |  1996-09-02  |  4KB  |  66 lines
  1.  
  2. VTIMES(3)                  UNIX Programmer's Manual                  VTIMES(3)
  3.  
  4. NNAAMMEE
  5.      vvttiimmeess - get information about resource utilization
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//vvttiimmeess..hh>>
  9.  
  10.      vvttiimmeess(_s_t_r_u_c_t _v_t_i_m_e_s _*_p_a_r___v_m, _s_t_r_u_c_t _v_t_i_m_e_s _*_c_h___v_m)
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy getrusage((22))..  IItt iiss aavvaaiillaabbllee ffrroomm tthhee
  14.      ccoommppaattiibbiilliittyy lliibbrraarryy,, lliibbccoommppaatt..
  15.  
  16.      The vvttiimmeess() function returns accounting information for the current pro-
  17.      cess and for the terminated child processes of the current process.  Ei-
  18.      ther _p_a_r___v_m or _c_h___v_m or both may be 0, in which case only the information
  19.      for the pointers which are non-zero is returned.
  20.  
  21.      After the call, each buffer contains information as defined by the con-
  22.      tents of the include file _/_u_s_r_/_i_n_c_l_u_d_e_/_s_y_s_/_v_t_i_m_e_s_._h:
  23.  
  24.            struct vtimes {
  25.                    int     vm_utime;       /* user time (*HZ) */
  26.                    int     vm_stime;       /* system time (*HZ) */
  27.                    /* divide next two by utime+stime to get averages */
  28.                    unsigned vm_idsrss;     /* integral of d+s rss */
  29.                    unsigned vm_ixrss;      /* integral of text rss */
  30.                    int     vm_maxrss;      /* maximum rss */
  31.                    int     vm_majflt;      /* major page faults */
  32.                    int     vm_minflt;      /* minor page faults */
  33.                    int     vm_nswap;       /* number of swaps */
  34.                    int     vm_inblk;       /* block reads */
  35.                    int     vm_oublk;       /* block writes */
  36.            };
  37.  
  38.      The _v_m___u_t_i_m_e and _v_m___s_t_i_m_e fields give the user and system time respec-
  39.      tively in 60ths of a second (or 50ths if that is the frequency of wall
  40.      current in your locality.) The _v_m___i_d_r_s_s and _v_m___i_x_r_s_s measure memory us-
  41.      age.  They are computed by integrating the number of memory pages in use
  42.      each over CPU time.  They are reported as though computed discretely,
  43.      adding the current memory usage (in 512 byte pages) each time the clock
  44.      ticks.  If a process used 5 core pages over 1 cpu-second for its data and
  45.      stack, then _v_m___i_d_s_r_s_s would have the value 5*60, where _v_m___u_t_i_m_e_+_v_m___s_t_i_m_e
  46.      would be the 60.  The _V_m___i_d_s_r_s_s argument integrates data and stack seg-
  47.      ment usage, while _v_m___i_x_r_s_s integrates text segment usage.  The _V_m___m_a_x_r_s_s
  48.      function reports the maximum instantaneous sum of the text+data+stack
  49.      core-resident page count.
  50.  
  51.      The _v_m___m_a_j_f_l_t field gives the number of page faults which resulted in
  52.      disk activity; the _v_m___m_i_n_f_l_t field gives the number of page faults in-
  53.      curred in simulation of reference bits; _v_m___n_s_w_a_p is the number of swaps
  54.      which occurred.  The number of file system input/output events are re-
  55.      ported in _v_m___i_n_b_l_k and _v_m___o_u_b_l_k These numbers account only for real I/O;
  56.      data supplied by the caching mechanism is charged only to the first pro-
  57.      cess to read or write the data.
  58.  
  59. SSEEEE AALLSSOO
  60.      time(2),  wait3(2),  getrusage(2)
  61.  
  62. HHIISSTTOORRYY
  63.      The vvlliimmiitt() function appeared in 4.2BSD.
  64.  
  65. 4th Berkeley Distribution        June 4, 1993                                1
  66.